home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / nt / polyv170.zip / polyview.doc next >
Text File  |  1995-04-22  |  16KB  |  412 lines
  1.                    PolyView User's Manual
  2.                              for
  3.                     PolyView Version 1.70
  4.                              by
  5.                           Polybytes
  6.                               
  7.                   Copyright 1995 Polybytes
  8.                               
  9.  
  10. Introduction
  11.  
  12.      PolyView is a multi-threaded 32-bit Microsoft Windows
  13.      NT application which provides viewing and image
  14.      manipulation support for JPEG, GIF, photo-cd, and
  15.      Windows and OS/2 8 and 24 bit BMP files. PolyView was
  16.      written and tested using Microsoft Windows NT
  17.      Workstation Version 3.5.
  18.      
  19. Registration
  20.  
  21.      PolyView is distributed as shareware. To register your
  22.      copy, send $20.00 to:
  23.      
  24.           Polybytes
  25.           3427 Bever Avenue S.E.
  26.           Cedar Rapids, Iowa 52403
  27.           
  28.      Registered users will receive product update
  29.      notifications and problem assistance.
  30.      
  31. Support
  32.  
  33.      All users are encouraged to communicate praise and
  34.      problems via e-mail to:
  35.      
  36.           PolyView@aol.com
  37.      
  38. Limitations
  39.  
  40.      PolyView supports 8 bit (256 colors), 16 bit (64K
  41.      colors) and 24 bit (2.7M color) display modes for JPEG,
  42.      GIF, photo-cd, and 8 bit BMP files. 24 bit BMP files
  43.      are supported only in 16 or 24 bit display modes.
  44.      
  45. Running PolyView
  46.  
  47.      PolyView.exe is the executable file which contains the
  48.      implementation of the PolyView application. PolyView
  49.      can be executed by Running it from the Program Manager
  50.      or File Manager.
  51.      
  52.      A recommended way to run PolyView is to use the File
  53.      Manager's File:Associate... command to associate a file
  54.      extension (.JPG, .GIF, and .BMP) with the PolyView
  55.      application. Then simply double-clicking an image file
  56.      will execute PolyView (if it is not already running)
  57.      and display the image.
  58.      
  59. Drag-and-Drop from File Manager
  60.      
  61.      PolyView supports drag-and-drop from the File Manager.
  62.      Drag-and-drop a file on a running PolyView application,
  63.      or on PolyView's minimize icon, to send the file or
  64.      files to PolyView. Depending upon the drag-and-drop
  65.      options selected from the Properties dialog, Polyview
  66.      will
  67.      
  68.           * Create a new window for each dragged file
  69.      
  70.           * Create a new slide show from the dragged files
  71.      
  72.           * Add the new files to an existing slide show
  73.      
  74.      Caution: If PolyView is configured to create a new
  75.      window for each dragged file and a large number of
  76.      files are "dropped", then PolyView can fairly quickly
  77.      use up large amounts of the real and virtual memory
  78.      resources in your system. If this occurs accidentally,
  79.      the multithreaded nature of PolyView will allow you to
  80.      correct your mistake by choosing the File:Exit command
  81.      to terminate file decompression and release all
  82.      resources.
  83.      
  84. Registry Usage
  85.  
  86.      Beginning with Version 1.70, PolyView uses the registry
  87.      for the storage of all information pertaining to
  88.      individual user settings from the Properties menu, most
  89.      recently used file list, and the most recently used
  90.      directory. The old polyview.ini file in the windows
  91.      directory (WINNT35, WINDOWS, etc.) is no longer needed
  92.      and may be discarded.
  93.      
  94.      Also starting with Version 1.70, PolyView automatically
  95.      registers itself with the File Manager or Windows 95
  96.      Explorer upon startup. This registration includes the
  97.      specification of the relevant DDE information so that
  98.      PolyView will be automatically started when a PolyView
  99.      "document" is run. The association of a file type with
  100.      PolyView is automatically done for JPG, GIF, PCD, and
  101.      BMP files, but only if an association for the
  102.      particular file type does not previously exist. If you
  103.      wish to replace an existing association, delete it from
  104.      the registry (using REGEDIT or REGEDIT32) and rerun
  105.      PolyView.
  106.      
  107. File Menu
  108.  
  109.      The File menu contains commands to:
  110.      
  111.           * Open and close image files
  112.           
  113.           * Start a slide show
  114.           
  115.           * Select from a list of the most recently viewed
  116.           images
  117.           
  118.           * Exit the PolyView application
  119.      
  120. View Menu
  121.  
  122.      The View menu contains commands to:
  123.      
  124.            * Zoom In and Zoom Out through a chain of image
  125.           magnifications
  126.           
  127.           * Use the entire display screen to view an image
  128.           
  129.           * Use the entire display screen to automatically
  130.           cycle through ALL the loaded images
  131.           
  132.           * Resize an image to better utilize the available
  133.           display
  134.           
  135.           * Change the mapping of an image to display its
  136.           full resolution
  137.           
  138.           * Enable and disable the display of the tool bar
  139.           and status bar
  140.      
  141. Options Menu
  142.  
  143.      The Options menu contains commands to:
  144.      
  145.           * Adjust the brightness, contrast, and colors of
  146.           an image (when the mode is Half Tone)
  147.           
  148.           * Invoke the Properties dialog to change
  149.           PolyView's configuration
  150.      
  151. Windows Menu
  152.  
  153.      The Windows menu contains commands to:
  154.      
  155.           * Change the positioning of the displayed images
  156.           
  157.           * Select an image from a list of active image
  158.           windows
  159.      
  160. The Toolbar
  161.  
  162.      PolyView's toolbar contains buttons for:
  163.      
  164.           * Opening files
  165.           
  166.           * Invoking full screen display mode
  167.           
  168.           * Manipulating the image appearance (active if the
  169.           display mode is set to Half Tone)
  170.           
  171.           * Viewing the PolyView About dialog box
  172.      
  173.      PolyView's toolbar is a docking toolbar. This means
  174.      that it can be grabbed with the left mouse button and
  175.      dragged to a new position within the PolyView window.
  176.      If positioned against an edge of the window it will be
  177.      docked there. The toolbar can also be left floating
  178.      anywhere in the window, or made invisible through the
  179.      View:Toolbar command.
  180.  
  181. Full Screen Display Modes
  182.  
  183.      The File:Slideshow, View:Full Screen View, and
  184.      View:Auto-browse Images commands display the current
  185.      image using the entire display screen. In Slideshow or
  186.      Auto-browse modes, images will be changed at the rate
  187.      indicated by the "Browsed Image Display Time" field of
  188.      the General Properties dialog box. Full screen mode is
  189.      cancelled by pressing a key on the keyboard. Images
  190.      displayed in full screen mode will be downscaled to fit
  191.      the screen if the raw image size exceeds the screen
  192.      pixel dimensions.
  193.      
  194.      While browsing images in full screen mode, the left and
  195.      right mouse buttons can be used to manually cycle
  196.      through the selected images, cancelling any timed image
  197.      cycling that is in progress. The left mouse button
  198.      causes the display of the previously displayed image,
  199.      and the right mouse button causes the display of the
  200.      next image.
  201.      
  202.      When a slide show is manually browsed there will be
  203.      periods of time after a new image is displayed when the
  204.      next image will not be available for display. During
  205.      this file decompression period the system will display
  206.      an hourglass cursor. PolyView attempts to load the next
  207.      image to be displayed by assuming that it is the next
  208.      file in the slideshow list in the direction that was
  209.      directed by the last mouse click. When a manual
  210.      slideshow is initially started, PolyView displays the
  211.      first image and begins reading the next image to the
  212.      right (the second image in the list of slideshow
  213.      files). At this time the last file in the slideshow
  214.      file list is not loaded, so a left mouse button click
  215.      after the hourglass cursor disappears will start it
  216.      loading. When the hourglass again disappears a left
  217.      button click will move to that image.
  218.  
  219. Zooming the Image
  220.  
  221.      PolyView can change the magnification of a displayed
  222.      image in several ways.
  223.      
  224.      The View:Zoom In command increases the magnification of
  225.      a displayed image by about 50%. The original window
  226.      size is maintained, with the center of the newly
  227.      magnified image the same as that at the previous
  228.      magnification.
  229.      
  230.      The View:Zoom Out command decreases the magnification
  231.      and display position to the previous magnification.
  232.      
  233.      An interactive zoom is provided by using the left mouse
  234.      button to draw a rectangle around the area to be
  235.      displayed in the magnified image. When the button is
  236.      released, the image will be rescaled. The View:Zoom Out
  237.      command can be used to go back to the previous
  238.      magnification.
  239.      
  240. Panning
  241.  
  242.      Images that do not fit within a displayed window can be
  243.      panned (positioned) by using the scroll-bars that
  244.      appear on the window. Note that panning smoothness is
  245.      severely constrained by the selection of the Half Tone
  246.      display mode.
  247.      
  248. Image Appearance Manipulation
  249.  
  250.      The appearance of an image can be manipulated when the
  251.      display mode is set to the Half Tone mode via the
  252.      Properties dialog box. Although Half Tone mode has a
  253.      much slower display update than other modes, it does
  254.      allow the manipulation of brightness, contrast, color
  255.      intensity, and tint.
  256.      
  257.      The default display mode used for viewing an image is
  258.      either the mode set the last time the mode was changed
  259.      from the Properties dialog, or the mode last used for
  260.      that image when the use of the image specific
  261.      configuration file has been enabled.
  262.      
  263.      Some, if not all, Windows NT display drivers do not
  264.      function as indicated by the Win32 API when the screen
  265.      is configured for 24 bit color (True Color). The
  266.      symptom you will observe is that although the color
  267.      manipulation commands are enabled, they will appear to
  268.      be non-functional. This is also true when PolyView is
  269.      run under Windows 95.
  270.      
  271. Image Configuration File
  272.  
  273.      If the use of an image specific configuration file is
  274.      enabled through the Properties dialog then the
  275.      manipulation of the display mode and color/contrast
  276.      settings for that image will result in the creation of
  277.      a configuration file corresponding for the image. The
  278.      name of the file is derived from the name of the image
  279.      file by replacing the original file extension with the
  280.      extension "PVI". When this option is enabled, each time
  281.      an image is displayed it will use the settings from the
  282.      last time it was displayed.
  283.      
  284. File Properties
  285.  
  286.      The file properties are available from the
  287.      Options:Properties command under the File Properties
  288.      dialog box. These include:
  289.  
  290.           * Drag and Drop File Actions - controls whether
  291.           files dragged from the File Manager create new
  292.           image windows, or are used to create or augment a
  293.           slideshow.
  294.           
  295.           * Image File Open Actions - controls whether a
  296.           file opened by PolyView creates a new image window
  297.           or replaces the current image window.
  298.           
  299.           * Use image configuration files - controls whether
  300.           PolyView reads and writes configuration files for
  301.           images.
  302.           
  303. General Properties
  304.  
  305.      The general properties are available from the
  306.      Options:Properties command under the General Properties
  307.      dialog box. These include:
  308.      
  309.           * Display rendering mode - selects from the
  310.           available modes to control  the speed and accuracy
  311.           with which PolyView displays images.
  312.           
  313.           * Browsed Image Display Time - adjusts the minimum
  314.           time an image will be displayed on the screen in
  315.           Auto-Browse or Slideshow modes.
  316.           
  317.           * Timed Browsing Mode - controls whether a
  318.           slideshow or image browse cycles once through the
  319.           images, cycles continuously through the images, or
  320.           cycles manually via user mouse button clicks.
  321.           
  322.           * Default One-For-One Mapping - if checked then
  323.           PolyView will not rescale an large image to fit
  324.           the available viewing space. Instead a window with
  325.           scroll bars will be displayed.
  326.           
  327. JPEG Decompression Control Properties
  328.      
  329.      The JPEG decompression options are available from the
  330.      Options:Properties command under the JPEG Properties
  331.      dialog box.
  332.      
  333.      The JPEG algorithms used by PolyView provide several
  334.      methods of performing the Discrete Cosine Transform
  335.      (DCT) during JPEG format file decompression. The
  336.      methods available include:
  337.      
  338.           * Fast but inaccurate integers - this is the
  339.           fastest method on most machines, but may suffer
  340.           from degraded image quality. For many images there
  341.           may be little visible degradation.
  342.           
  343.           * Slow but accurate integers - this method is
  344.           slower than the first method, but achieves high
  345.           quality results.
  346.           
  347.           * Fast or slow but accurate floating point - this
  348.           highly accurate method may be the fastest on some
  349.           machines, but on machines without floating point
  350.           capability will be VERY slow.
  351.      
  352.      Chroma component upsampling characteristics control the
  353.      speed and accuracy of certain color manipulations
  354.      performed during decompression. The methods available
  355.      include:
  356.      
  357.           * Fast but less accurate
  358.      
  359.           * Slower but more accurate
  360.      
  361.      When the screen characteristics are set to 8 bit color
  362.      mode (256 colors), then color quantization is performed
  363.      during decompression. The methods available for this
  364.      quantization include:
  365.      
  366.           * Two pass quantization - in this mode the entire
  367.           image is scanned once to determine the optimum
  368.           color map to use, then scanned again to build the
  369.           final image. This is naturally slower than a
  370.           single pass mode, but does a much better job of
  371.           rendering colors.
  372.           
  373.           * Color dithering - color dithering can improve
  374.           the color characteristics of the decompressed
  375.           image in both single and two pass modes, but the
  376.           effects of dithering can be pronounced in single
  377.           pass mode.
  378.      
  379. PolyView Version History
  380.  
  381.      1.00 Initial release.
  382.      1.10 Added default saving for application and image
  383.      configuration defaults.
  384.           Added "View:Resize to fit" command.
  385.      1.20 Added JPEG DCT method choice.
  386.           Changed bitmap algorithms for better Win95
  387.      compatibility.
  388.      1.30 Added support for 8 bit color modes.
  389.      1.40 Added "on-the-fly" image painting during file
  390.      reading.
  391.           Remember last screen position and state.
  392.           Remember last directory used to open a file.
  393.      1.50 Added full screen viewing mode.
  394.      1.60 Added slide show viewing mode.
  395.           Added properties dialog and additional JPEG
  396.      decompression options.
  397.      1.70 Added photo-cd file support.
  398.           Added system registry use for file association,
  399.           DDE commands, and replacement of polyview.ini.
  400.  
  401. Credits
  402.  
  403.      The Graphics Interchange Format(c) is the Copyright
  404.      property of CompuServe Incorporated. GIF(sm) is a
  405.      Service Mark property of CompuServe Incorporated.
  406.      
  407.      Microsoft Windows NT is a registered trademark of the
  408.      Microsoft Corporation.
  409.      
  410.      PolyView is in part based on the work of the
  411.      Independent JPEG Group.
  412.